Skip to content

Simplify, add more direct links, etc - #21

Open
scrubbbbs wants to merge 1 commit into
nomacs:mainfrom
scrubbbbs:patch-3
Open

Simplify, add more direct links, etc#21
scrubbbbs wants to merge 1 commit into
nomacs:mainfrom
scrubbbbs:patch-3

Conversation

@scrubbbbs

Copy link
Copy Markdown
Contributor

Trying to streamline and cut down on noise a bit

  • Add direct links for all common platforms
  • Remove Linux distro details, replace with helper links. This is no longer helpful or noteworthy.
  • Versionless links to reduce maintenance requirements. Each stable release will include builds for all platforms.

Trying to streamline and cut down on noise a bit
- Add direct links for all common platforms
- Remove Linux distro details, replace with helper links. This is no longer helpful or noteworthy.
- Versionless links to reduce maintenance requirements. Each stable release will include builds for all platforms.
## Third-Party Linux/Unix Packages

Translations can be installed from the package `nomacs-l10n`.
nomacs is available on practically everything by this point, but beware of old versions and bleeding-edge beta releases. If you must have a full-featured stable release, we recommend the official AppImage or FlatPak as beta releases will be testing new features.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nomacs is available on practically everything by this point

I would avoid using this kind of statement.

but beware of old versions and bleeding-edge beta releases. If you must have a full-featured stable release, we recommend the official AppImage or FlatPak as beta releases will be testing new features.

This isn't clear because a new reader would have no clue for what is beta and what is not. I think we need to document our version system. I remember there was a discussion to move away from the odd number and even number scheme at some point, but it seems to no longer be the case.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems we have been roughly using the even/odd convention since 3.16 at least which is the oldest version floating around in repos. I don't think the release cadence is frequent enough for SemVer, it might confuse existing users and package maintainers.

How about:

You will most likely find nomacs in your current distribution's package manager. But beware of old versions, sometimes they lag behind by several years. In these cases we recommend the current AppImage or FlatPak.

Comment on lines +46 to +47
- [Check Available Distributions (pkgs.org)](https://pkgs.org/search/?q=nomacs)
- [PkgForge AppImage Hub](https://docs.pkgforge.dev/) may offer additional architectures.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we should replace links to official distro-specific pages with pkgs.org or docs.pkgforge.dev. I can trust official package sources, but I can't say the same with sufficient confidence about these two third-party sites. For that reason, I don't think it is appropriate for us to direct visitors there to download or install software.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants